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GENERAL 


The Network Definition Language (NDL) Library consists o f 
procedures used in the operation of terminals that interface with 
~6©81800/81700 series computers. The tibrary is a source tanguage 
Library that contains the REGUESTS and CONTROLS necessary to 
handle common tine disciplines for the terminal devices 
referenced hereine By utitizing the library» users should find 
at unnecessary to write their own REQUESTS and CONTROLS. 


- - RELATED PUBLICATIONS 


NAME. a - NUABER 


‘NOL Manual 1073715 
Network Definition Language . PeSe 2212 5223 
COMMUNICATION PROCEDURES Pe Se 1284 9006 
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ACCESSING THE LIBRARY 


The Library of. tine disciplines dosctaped herein is a reteased 
prayer in the NOL system and is named NOL/LIBRARY- 


| This. library consists of a nuaber of groups of source statements 
| poged in NOL CNe twor k Definition Language). Each source image is 


90“character recorde Positions 1 through 72 contain the NODL 


Colic while positions 73°80 contain a unique sequence numbere § A 


patch information field begins in column 81 of the record image. 
The format displayed is the same as for SDL: 


 LeEer <BASE> <VERSION> <ID> 


<DIGIT> <DIGIT> CEeGer "907 | 
<CHARACTER> <CHARACTER> CE.Ge» "01" OR "A ™ OK 
ANY STRING OF SIX CHARACTERS. _ 

(EeGee "T02344") > 


WHERE <BASE> 
<VERSTON> 
<ID> | 


bow ou 


The printed patch would appear on the tiorary Listing as: 


—™9.0 01 102344" 


‘The patch field is printed only during a $CREATE or SUPDATE 
compiles it does appear on listings where library decks are 
extracted via the SLISRARY controt card directive. 


Each group of source statements constitutes a procedure 
(declarative or executable). These procedures fall into three 
classes: close canner ee DECLARATIONS» and CONTROLS. — 


Including the appropriate. : $LIBRARY statement in a compite deck 
places any of these procedures» intact» into an. NDL compile. For 
instances $LIBRARY POLLTICTO> when placed correctly in a 
compilation deck passed to the NOL Compiter» causes all source 
statements in the procedure named POLLTCTO from the NDL/LIBRARY 
fites to be included into the source passed to the compiler. 


A typical compilation deck will appear as follows: 
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2COMPILE HANDLER WITH NDL To LISRARYS 
2DATA CARDS 
DECLARATION: 
: NIF = "HANDLER"/*NIF™. 
SLIBRARY POLLTCTOD 
SLIBRARY SELECTCTD 
SLIGRARY POLSELCTL 


«TERMINAL SECTION STATEMENTS> 
 <STATION SECTION STATEMENTS> 
<LINE SECTION STATEMENTS> | 
<FILE SECTION STATEMENTS> 
FINI. 
PENDS 


The Network Controller generated by this deck with the <SECTLON 
STATEMENTS> appropriately completed and with the aid of an 


applications programs communicates to a network composed.of TC~» 


TO~» Tis» TUm» and AEwtype terminals. 


NOTES The $LIBRARY cards take the place of WNOL executabdte 
| statements tn the deck. The compiler replaces these 
S$LIBRARY cards with actual source statements found in. the 
 NDL/LEIBRARY fite under their Ree eesvre’ name (POLLTCTDs or 
SELECTCTOs etce). ~ 
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NDL/LISRARY FILE 


The NDL/LIBRARY file contains a number of DECLARATIONS» REQUESTS 
and CUNTROLS each designed to be used with a certain ciass or 
type of terminal. — | _ 3 | - : 


Additionally» these REQUESTS and cCOGATROLS fall into generat 


groupings as to the Line discipline employed. 


Each of the fotlowing descriptions indicate the type of line 
discipline for which it is intended Cunderlined) and the nameCs) 


of the REQUESTCs) which it describes. 


The purpose of this approach is to provide a detailed description 
of the action in a REQUEST or CONTROL which may be used in 
conjunction with a full Listing of that REQUEST or CONTRUL to 
obtain a more complete understandirg of a particular’ tine 


discipline and its implementation. 


‘The ‘purpose of a DECLARATION is to assign vatues to constant 


names» declare an audit file» name the NIF file» define a signal 
character for an MCS» and establish the maximum number of TOGGLES 
and TALLYS. Some CONTROLS and REQUESTS may require the use of a 
DECLARATION from the NDL/LIBRAKY. 


NAMES RJE3780DCLS 


This DECLARATION section contains the constants used tin the 
-RJE3780 REQUESTS and CONTROLS sections. It is invoked Dy a 
"SLIBRARY RJE3780DCLS" card in the NUL source deck. | 
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| CANDE 
NAMES CANDEDEC | 


This DECLARATION section contains the defined constants used in 


the CANDE REQUESTS and CONTROLS. 


— sycou 


NAMES SYCOMDECL 


This DECLARATION section contains the defined constants used in 
the SYCOM REQUESTS and CONTRUJLS. CInctuded also are the defined 
character strings which are treated as pseudo~procedur es» 1 e@e 
they are expanded into inline code at compite time). 


NAME? CUS0L74DEC 


This DECLARATION section contains the defined constants used in 
the COBOL 74 REQUEST. 


Seale. 


The purpose of a REQUEST is to perform a particular communication 


procedure with the assigned station. 


INPUT REQUESTS — 


- The input REQUEST performs basically two functions: 


‘ae 7. Querying a terminal for. messages it may have READY to 


transmit. 


ie. | Receiving messages and routing them to ee remote file to 


which: the terminal is attached. 
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NAME? PULLTCTD 


This REQUEST issues one PULL Cwhen AUTOPOLL is not in operation) 
to a station and receives either a messages or an EUT indicating 
no nee ge ready. | 


Line (TO0GfL1]) is set by the initiating COATROL if AUTUPULL was 
initiateds otherwise it is reset. This TOGGLE is used to avoid 
issuing another POLL if AUTOPOLL was in process. TIME CTALLY) is 


set upon input to correspond to COS80L74 requirements. 


The REQUEST code is exited if no message is received in response 


to the POLL. If a message is receiveds then it is acknowledged» 


queued for the MCS or passed on to the User Program's remote file 


with which the assigned station is associatede. The RLQUEST is 
then exited. | 


 I/U errors: other than ENDOFBUFFER> LOSSOFODSR» and TIMEOUT» cause 


the RETRY count to be decremented and the REQUEST exited. If the 
Line is a switched-tines TIMEOUTS cause the RETRY count to de 


decremented to attow a tine disconnect when RETRY = Oe 


Consecutive errors that cause the RETRY count to go to zero cause 
the REQUEST to perform a TERMINATE ERROR or a_ TERMINATE 
DISCONNECT. This exiting of the REQUEST on a leased-line ieaves 
the station READY and queues an error message for the MCSs if 
presente If there is no MCS in the system then the station 
remains READY and a message is passed on to the User Program's 


remote file which causes the EXCEPTION branch to be taken on the 


ae: of ne remote file. 


If the User Program attempts to receive a message which 1s too 
-targe for the Network Contrclter to communicates this REQUEST 


informs the intended sender by the following error notice and 


then proceeds to the next Datacoam transfer: 


#**xABORT/XMITS MSG GTR BUFFERSIZE*#®. 


‘This REQUEST checks incoming messages for a transmission number» 
af one is dectared in the TERMINAL Section. If two consecutive 


aveenoe have the same transaission number» the second message is 
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discarded. 


DYNAMIC 
NAMES POLTCTODYN 


This speciat-purpose REQUEST is intended to be used only with 


AUTOOYNCTL Library CONTROL to provide dynamic reconfiguration of 
the AUTUOPOLL POLL List of stations on a given Line. Lines may 
have more than one tine address (referred to as LINE GROUPS). 
Refer to the discussion of the CONTROL for further information. 


The REQUEST performs similarly to POLLTCTD when no exceptions 


occur on any station. 


When a potied station incurs a TIMEQUT exception» an indicator is 
checked to determine its status prior to the exception. If the 
terminal has never been recognized as having been ON-LINE it is 
polled once again. If the station TIMES QUT agains it is removed 


from the POLL list. If the station has been in use without 


errors it is single~potted once. if it TIMES GUT againe it is 


removed from the POLL list and marked to be retried in three (3) 


minutese 


If the exception incurred is LOSSOFDSR and if the line was 
established as switched» it is disconnected; otherwise the 


exception is treated as any other non TIMEOUT exception. 


The effect of the special action taken on a TIMESDUT is that when 
a Station is powered one the Network Controller determines how 
many stations are responding and recscreates the AUTOPOLL POLL 
list accordingly. When a station is powered off» the AUTOPOLL 


POLL List is simitarly re-created» including only those stations 


that are actively responding. 


If a station has been marked as ONCE ACTIVE BUT NOW POWERED OFF 
and is to be retried in three (3) minutes» the entire list of 
Stations is retested for availability and the POLL list is 


created accordingly. Criteria for acceptance to the new POLL 
List ares (1) at has never been used by any tine or is not now 
in use by any line and (2) it does not TIMEQUT when poiled. 
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The vate of theese (3) minutes for RETRY SS a cunecanc.eet in the. 
Library CONTROL code for AUTUDYNCTL and may 5e altered by the 
user if desired. . 


oo which are too large for the Network Controtter to 
Communicate are handled as in the POLLTCTD REQUEST. 


NAME: CANDEPOLTD 


The CANDE input. REQUEST performs simitarly to the standard 
REQUEST POLLICTD with the fotlowing additions. | 


An input control system is implemented which determines whether 
or not a station is to be included in the AUTOPOLL PULL string 
based on TIMEUUTs on POLL. TOG{14] is the flag indicating that 
this station has had RETRY consecutive TIMEOUTS on PULL and is to 
be deteted from the POLL string. Only stations with TOGT14) 
false are placed in the POLL string. Every minutes by default» 
one of those stations with TJGC14] true is given one single POLL. 
If the station has not responded with EOT after 100 milliseconds» 
by defaults» the read is cancelled and the station is teft marked 
"down". The above mentioned “defautt™ vaiues along with some 
others are declared in a Library declaration section for CANDE 
named “CANDEDEC™. These values may De overridden at compile time 
by inctuding a "DEFINE" statement after the "“S$LIBRARY CANDEDEC™ 
Statement. See documentation in “CANDETDCTL™ for a more complete 
explanation. : - : " & 


An output control system prevents output messages bound to a 
~—~station which is not allowing them to be received (terminal is in 
LOCAL or message has an unrecoverable error) from being retried 
forever to the detriment of the response time of the rest of the 


stations. TUGL10] telts the CUNTROL that this station is not 


receiving outputs the CONTROL does not attempt output until this 
flag iis off. The receipt of a ? in the first position fottowed 
immediately by an ETX Cof the input message from a station)» 
resets 1706€10)] for that station and allows output to be sent. 
Also» any input including valid CANDE commands enables the output 
queue againe While TOGL10] is true» the POLL string inctudes a 


 - select sequence for the station. This means the station wilt be 


— constantly “NAK"ing © the select until the terminal is ptaced in 
"RECEIVE" at which time the message is sent and the _ select 
- sequence is removed from the POLL string. _ 
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Scrolting is available to 108207830 type terminals when TYPE 15 


set correctly in the TERMINAL Section of the Network Controller. 


An input of ?¢+ enables scrotling» ?- disables scrottling. 


Scrolling may also be controtted programatically by setting the 


vwatue of TALLYCO]. When TALLYCO] is set to 254» scrolling is 


enabled if the TYPE is correct» and when TALLY{0] is set to 255» 
scrotting is disabled. Scrolling of input ts performed as 
follows. After Pecoune of inputs 


ae » Clear to the end of the line. 

b. Nove cur sor to Home. 

Ce | Leave terminal in RECEIVE node. 

de eee up one awe This puts the top. ‘ine on the neice 


of the screen. and brings the second Line up to the top of 
the screene 


Ce Clear the top line. 


Error recovery is similar to the standard PUOLLTCTD REQUEST. 
END OF BUFFER conditions are handled the same with smatt 
modifications to accommodate CANDE. TIMEGUTS are handled by the 
dynamic input controt system $If a station is marked INPUT 
DISABLED by the input control system then a TERMINATE ERROR. is 
performed to infora CANDE that tt must recover ol user active at 


acne statione 


if the terminat is in use only by CANDE (no = other job executed 
through CANOE is attached to it)» the REQUEST maintains the 
cursor position as required by CANDE. If the terminal is in use 
by any other job» then the cursor position is not maintained in 
any wWaye | — —— : | re | 


“NAMES CANDAUDPOL 


This request per forms exactly tike "CANDEPOLTO" with the addition 


that it uses an audit file to trace its operation. It is 


-inctuded in the library so that it may be used in diagnosing the 
fine activity or documenting any suspected problem in_ the 
requeste | | rs 4 
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POINTSTO“POINT 


NAMES? TCTUPTRCV> TOPTRCV 


These input REQUESTS establish communication. on a master/stave 


basis. Initially the REQUEST waits Cwithout TIMEQUT) for the 
station to bid for status. Upon the station biddings 


communication is established and the input message is passed on 


to the User Program's remote file or queued for the MCS» i f 


presente When the transaction is completed» master status must 


de remestablished by the terminal for the next message. 


When in the output REQUEST and trying to establish gaster status» 
the input REQUEST also bids for master status» the output KEQUEST 
code is exited and control given to the input REQUEST. The input 
REQUEST now waits Cwithout TIMEOUT) for the station to did again 


for master statu Se 


dae the TcTuPTRCY REQUEST» 1/0 errors other than TIMEOUT cause 
the RETRY count to be decremented and the REQUEST exited. The 


TOPTRCV REQUEST operates similarly except that exception 


conditions upon establishing communication do not directly 


decrement the RETRY counters Consecutive errors that cause the 
RETRY count to go to zero cause the REQUESTS to perform a 
TERMINATE ERROR or a TERMINATE DISCONNECT. This exit from the 
REQUEST on a leased-Line leaves the station READY and queues an 
error message for the MCS» if present. If there is no MCS tn the 
System then the station remains READY and a message is passed on 
to the User Program's remote file» which causes the EXCEPTION 
branch to be taken on the READ of the remote file. | 


Should a message be received by an User Procram which exceeds. the 
BUFFERSIZE as defined in the Network Controtter» the partial 
message which does not exceed the BUFFERSTZE is passed on to the 
intended receiver as if no errors had occurred. 


a 
ity ut 
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TELETYPE 


NAMES REAOTTY 


A KEAD with NO TIMEOUT is issued and upon receipt of ENQ» CR or 
ETX» the carriage is automatically positioned in the far teft 
margin and advanced one line. Since the REQUEST is sensitive to 
a Carriage Returns an ETX» or an ENQ Cas ending control codes)» 


the REQUEST must check which code was actually received before 


returning the carriagee If an ENQ@ was received then the message 
is discarded and a READ with NO TIMEOUT is initiated. If an ETX 


or CR was received then the message is queued for the User 


Program or MCS and the REQUEST is exited. 


Any errors whether an I/0 exception or receipt of an invalid 
response» causes the RETRY count to be decremented and the 
REQUEST exited. Consecutive errors which cause the RETRY count 
to go to zero cause the REQUEST to perform a TERMINATE ERRUR or 
TERMINATE DISCONNECT which notifies the User Program through the 


EXCEPTION branch of the READ. {f an MCS is presents» an error 
message is queued for ite | 


Attempts to transmit messages from the teletype keyboard which 
exceed the BUFFERSIZE defined in the Network Controller are 


aborted. The message: 


#eeABORT/XMIT? MSG GTR SUFFERSIZE*** 
is disptayed on the teletype console to indicate this error. 


sain REQUESTS 


“the output REQUEST performs the function of transmitting to the 


renew any message designated as output froma the system. 


fo 
=a 
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SELECT | | 


NAMES SELECTCTD 


The basic purpose of this REQUEST is to transmit messages to an 
assigned station by means of the standard SELECT Line discipline. 


If an ACK is received in response to the SELECT» the output 


message is sent. When the acknowledgement is received for the 


message» the transaission number ts updated» the output message 


18 cleared from memory and the REQUEST is exited. If a NAK is 


received in response to the SELECT then the output message 15 


re-~queued and the REQUEST is exited. 


1/0 errors other than ENDO BUFFER» LOSSOFDSR and TIMEUUT cause 
the RETRY count to be decremented and the REQUEST exited. 
However» TIMEOUTS on a switched tine cause the RETRY counters to 


be decremented to eventually allow a tine disconnect when RETRY = 


0. Consecutive errors that cause the RETRY count to go to zero. 
cause the REQUEST to perform a TERMINATE ERROR or TERMINATE 


DISCONNECT. If an MCS is present» this exiting of the REQUEST on 
@ teased-line leaves the assigned station READY and queues an 


error message for the MCS. If there is no MCS in the system then 


the assigned station remains READY and a message is passed on to 


the User Program's remote file» which causes the EXCEPTIUN branch 


to be taken on the next READ of the remote file. 


This REQUEST sends a transmission number with the output message 


if TRANSMISSION is dectared in the TERMINAL Section for the 


assigned station. The TC terminals (CTC500» =YC700>- etc.) 


transmission numbers are incremented consecutively Ciee-» Or I>, 
29 3»  etce) whereas the TD terminals (TO/70C>» TO800> etc.) 
alternate transmission numbers between 0 and le. | 


If the User Program attempts to send a message which is too Large 


for the Network Controtter» this REQUEST notifies the intended 


receiver of the message by the fotlowing error notice and then 


proceeds to the next Datacomm transfer. 


* ABORT/RECVS MSG GTR BUFFERSIZE * 


ae 
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COsOL SELECT 


NAMES COBUL74SEL 


The purpose of this output request is to implement the carriage 
control specified tin a COBOL WRITE statement. The overatt action 


of the REQUEST is similar to the SELECTCTD REQUEST. 


The carriage control feature of this REQUEST is handled via TOGs 
and TALLYs. TOG{2] represents SKIP or SPACE with values of 0 and 
il» respectively. TUG(C3] represents BEFORE and AFTER with values 


of OO and i>» respectively. TALLYCO] is used as the vatue 
associated with the SKIP or SPACE. TALLYC2)] is used internally 


as a temporary counter. 


SKIP to “channet™ has been implemented as a SKIP to screen Line 


number. In the special condition that SKIP to LINE NUMBER 1 is 
usede first the screen is cleared. 


The values for representing Line number or channel number have 


the range of 17-99 for SKIP and 0-255 for SPACE. Their validity 


is not checked by. this REQUEST. 


The onty valid INPUT REQUEST to use with this REQUEST is 
"POLLTCTO™. The valid CONTRULS are POLSELCTL"» "AUTOPOLCTL"» and 


any of the CANDE CONTROLS. 


This special purpose REQUEST is intended to be used only with 


AUTOOYNCTL CONTROL and in conjunction with input REQUEST 
POLTCTODYN. _to provide dynamic reconfiguration of stations on a 


tine. 


This wenieke nap tioda similarly to SELECTCTO when communicating 


with a T0830 Series terminat. If TERMINALTYPE is not set to a 
watue of 45 or 46» then the REQUEST attempts a FAST*SELECT. Upon 


an EXCEPTION or FORMAT error occurring on the READ of the 
FAST*SELECT» the REQUEST sets TUG£3] to 1 and normat SELECTs the 


station until the station is READY to receivee if TOG{L3] is true 


and TERMINALTYPE equals 45 or. 469 the REQUEST always normal 
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SELECTs as does the SELECTCTO REQUEST. 


NOTES TINEQUTS do not decrement the RETRY counter untess the 
line has been established as switcheds thereby allowing 
disconnect when RETRY = JU. If LOSSOFDSR is detected and 


the Line is switched» immediate disconnect 18 performed on 
the line. Utherwise» the RETRY counter ws decremented. 


This REQUEST sends a transmission number with the output message 
if a transmission nuaber is declared ir the TERMINAL Section for 
the assigned station- fhe TC terminats (TC500» TC700» etc.) 
transmission numbers are incremented consecutively Cieee» Ov» 1» 
2» 3» etc.) whereas the TD termirals (TD700- TO800» etc.) 


_ alternate transmission numbers between 0 and 1. 


If the User Program attempts to send a message which is too Large 
for the Network Controller to communicates» this REQUEST notifies 
the intended receiver of the message Dy the following error 
notices then proceeds to the next Datacomm Transfer. 


*ABORT/RECVs MSG GTR BUFFERSIZE*# 


NAMES CANDESELTD 


The CANDESELTO REQUEST performs similarly to the standard SELECT 
REQUEST with the same additions as discussed in the FASTSELECT 
-CANDE REQUEST. See CANDEFSLTO. | 


in additton»p the this REQUEST discards an output to a station 
when the station responds with an ACK to SELECT» but responds 
with a NAK to TEXT CRETRY consecutive times). This is to prevent 
messages containing irrecoverable errors in the TEXT from 
degrading the rest of the system. : | : a. 


NAMES CANDAUDSEL 


This is the same as the *“CANDESELTD* féquest with the addition a 
audit statement se 
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FAST SELECT 
NAME 5 FASTSELTCD 


Ihe FASTSELTCD REQUEST functions similarly to the SELZCT REQUESTs 
with the following differences: 


instead of issuing one I/0 to SELECT tne terminat and receive a 
response CACK or NAK) and then issuing another I/0 to transmit 


the output messages a single I/0 is issued which notifies the 


destination terminal that an output message is coming and 
immediately following the control sequence is the message itself. 


The terminat then returns ACK or NAK indicating receipt or 


nonreceicrt of the nessage. 


€rror recovery 1s Similar to that in the SELECT REQUESTS. 


Messages which are too targe for the Network Controller to 
coamunicate are handied as in the SELECTCTO REQUEST. 


LDN nies ome ener EE eas the alee oAe nie eee ae eee asians Past Ny aes Tm ee Racer nat ee near alee ent Selnye oa raty LM eee ceoamee UO hata fee ata Pato ELA ease eT oni abt tae eke hence ae ne gat eM ACE CME MEN oT OMEN Hes ence Neo ED hiceinGh TS CTEM Rit secur tTaN at Tela SOHNE MUTT TUE MT 
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NAMES CANDEFSLTD 


This sueput REQUEST perforas similarly to the standard FASTSELECT 


REQUEST with the following additions: 


ae  ~— Scrolling» when enabled» is performed on any output as 
follows: | - | 
1.  ## Move the cursor to Home. 
2. If tess than 23 consecutive outputs have occurred» 


then ieave the terminal in RECEIVE. 
Detete the top line. 


4e Move the cursor up one linee (CThis places it at the 
left» on the bottom tine of the screen.) 


Se Transmit the TEAT. 
6 Move the cursor to Home. 


De If the terminat receiving the output is defined as a 10830 
series CTYPE = 45 or 46)» thens before the FASTSELECT 
occurss a SELECT is performed. If the response is an ACK» 
the REQUEST proceeds as usuals otherwise» the error 
section is executed. | . | 


a | After one TIMEOUT on a FASTSELECT» the station 15 - garked 


as temporarity disabled for output and a select sequence 
for the station is placed in the POLL string. When the 
SELECT is ACKed the message is sent ands if no more 
messages are queued for the station» . the SELECT sequence 
1s ReaGve? oe the POLL strings | | : 


de Jf there is. one or more Lines of sutput from some program 
other than CANDE currently on the screen of a station with 
scrotling enabled» the station is piaced in LUCAL before a 
page of output from CANDE is displayed. 


| NAHE = CANDAUDF SL 


This request is the same as "CANDEF SLTD™ with the addition of 
audit statements. | _ : 
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-POINI=T0- POINT 
NAKES? TCTUPTXMIT» TOPTXMIT 


These output REQUESTs establish communication on a master/stave 
basise The REQUESTS initially atteapt to obtain saster status 
upon having an output. message queued. If upon bidding for master 
status the remote station is likewise bidding for status» the 
. output REQUE ST is exited allowing the remote station to again Did 
for master statuse | Should the station fail to rebid for status 
within the adapter TIMEOUT period» the output REQUEST again 
atteapts to establish master status before outputting its queued 
messages i 


For the TCTUPTXMIT REQUEST» I/U0 errors other than TIMEGUT cause 
the RETRY count to be decremented and the REQUEST exited. 
Howevers TIMEOUTS on a switched-Line cause the RETRY counter to 
be decremented to allow a tine disconnect when RETRY = O. °#The 
TOPTXMIT REQUEST operates similarly except att 1/0 errors cause 
the RETRY counter to be decremented. Consecutive errors that 
cause the RETRY count to go to zero cause the REQUEST to per fora 
a. ohhh ERROR or a TERMINATE DISCONNECT. This exiting of the 
REQUEST. a teased-line leaves the assigned station READY and 
queues. a eee ce message for the MCS» tf presente If there 1s no 


CS in the system then the assigned station remains READY and a 


message 1s passed on to the User Program's remote file. This 
causes the EXCEPTION branch to te taken on the next READ of the 
reaote file. 


-If the User Program attempts to send a message which is too large 
for the Network Controller to communicate» this REQUEST notifies 
the intended receiver of the message pdDy the folttowing error 
notice and then proceed to the next Datacomm transfer. a. 


 #eeABORT/RECV? MSG GTR BUFFERSIZE#** 


he NS Be Pee obey ase pepe Beare g ge eeepc ety MeO Siete Te eaR eS te eT eee gee ER RR Eg ET een ig gg EA PE UE See Sk cae oS” 


ahs DEREP EST Oper Pe Pireeee rey ree 
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WAME2  TDBATCHXMT 


This output REQUEST establishes communication on a master/slave 


basise The REQUEST initiaily attempts to obtain master status. 


upon having an output message queued. If upon bidding for master 


status the remote station is likewise bidding for status» the 


output REQUEST is exited attlowing the remote station to again did 
tor master status. . Should the statton fail to rebid for status 


within the adapter TIMEOUT period» the output REQUEST again 


attempts to establish master status defore outputting its queued 
messagee §$Upon outputting its message» a check is made to 
determine whether or not other output messages have been QUEUED. 
If the answer is. yes the REQUEST continues to output messages 
until the queue is empty» otherwise the REQUEST is exited 


immediatety. 


I/O errors other than TIMEQUT and ENOOFBUFFER» cause the RETRY 


count to be decremented and the REQUEST exited. However» 


TIMEQUTS on a switchedcline cause the RETRY counter’ to de 
decremented to allow a tine disconnect when RETRY = 0. 
Consecutive errors that cause the RETRY count to go to zero cause 
the REQUEST to perform a TERMINATE ERROR or TERMINATE DISCONNECT. 
This exiting of the REQUEST on teased-lines Leaves the assigned 
station READY and queues an error for the MCS» if present. If 
there is no MCS in the systems then the assigned station remains 


READY and a message is passed on to the User Program's remote 
fite. This causes the EXCEPTION branch to be taken on the next 


READ of the remote file. 


If the User Prograa attempts to send a message which is too large 


for the Network Controtter to communicates» this REQUEST notiftes 


the intended receiver of the message dy the following error 
MOENeS and then proceeds to the next Datacomm transfer: 


| #eWABORT/RECVE HSG GTR BUFFERSIZE**« 
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TELETYPE 


NAMES WRITETTY © 


This REQUEST transmits every message appended with a Carriage 
Return and a Line Feed character. If the. WRITE operation is 
coapleted without error» the output message is dewaitocated and 
the REQUEST is exited. | 7 a 4 


Any error except a BREAK causes the RETRY count to be 
decresented» the message re~queued and the REQUEST exited. 
Consecutive errors cause the REGUEST to perform a TERMINATE ERROR 
or a TERMINATE DISCONNECT» requeue the messages report the error 


to the MCS or the User Programs» and exit the REQUEST. If the 
error was a BREAK during the WRITE» the REQUEST automatically 
positions the carriage to the far left» advances one tine» and 


exits the REQUEST after de~allocating the output message 


Attempts to transmit messages to the teletype keyboard which 
exceed the BUFFERSIZE defined in the Network Controller are 
aborted. The following message is disclayed on the teletype 
console to indicate this error. : | = 


ee*ABORT/RECV: MSG GIR BUFFERSIZEs** 
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INPUT/QUIPUT REQUEST 


An input/output REQUEST performs the functions of Doth input and 
output without the need to de initiated by the CONTROL more than 
onces except under certain error conditions. | 


POLL/SELECT 
NAME? DIAGICTDIO 


The purpose of this REQUEST is to provide a minimal diagnostic 


capability in a readily available form in the LIBRARY. 


This REQUEST perforss both input and output functions for 


MULTI-PCINT terminals and provides a trace of ali activity 


between the system and the terminal. The trace is effected Dy 


@aking use of an AUDITFILE named ‘OIAG* which must be dectared in 


the DECLARATION Section of any Network Controiter which includes 
this REQUEST froa the LIGRARY. 


— Exampte: AUDITFILE DIAG (DEVICE= PRINTER OR BACKUP). 


The operations of the input and output sections of this REQUEST 


are identicat to that of the POLL and SELECT REQUEST Ss oe 


and SELECTCTO)» respectively. 


Although the diagnostic REQUEST can De specified itn a non7MCS 


configuration in the TERMINAL Section as REQUEST = DEAGTCTDIO = 


RECEIVE» DIAGTCTOIO = TRANSMIT» it is also an optional statement 
in a system utilizing an MCS» by specifying in the TERMINAL 


See LON: 


DIAGNOSTIC = DIAGTCTDIO: RECEIVEs DIAGTCTOIG: TRANSMIT 


This option allows» through a OCWRITE from the MCS» the ability 
to exit the current. REQUEST» enter the erage \e REMUE SEE and 
een to the original REQUEST if Beetees 7 
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nr 


This REQUEST sispabte shes. communication on a master/stave DaSiSe— 
Initiatly the REQUEST waits without TIMEOUT for either an output 


message to be queued Cwhich then cancels the TIMEQUT)» or for a 
station to request permission to transmit its message vuffer. 
Upon acknowtedging the station's request» mts message buffer 15 


received and passed to the User Program's remote file» or. queued 
for the MCS» if present. | : 


Att suepueuderationa Cereus TRANSMIT ACK» TRANSMIT NAK» TRANSMIT 


TEXT» etce) are determined by the value placed in LINE CTALLY(1)) 


which is constantly being updated by the REQUEST according to I/0 
communication. | 


Any errors» except ENDOFBUFFER» whether an I/0 error or receipt 


of an incorrect message or response» cause the RETRY count to be 
decremented and the REQUEST exited. Consecutive errors that 
cause the RETRY count to go to zero cause the REQUEST to perfora 
a TERMINATE ERROR or a TERMINATE DISCONNECT. This exiting of the 
REQUEST on lLeasedmlines Leaves the assigned station READY and 
queues an error sessage for the ACS» if present. If there is no 


MCS in the system then the assigned station remains READY and a 


message is passed onto the User Program's remote file. | This 
causes the EXCEPTION branch to be taken on the next READ of the 
reuote files. fs 


This REQUEST should be used ante with CONVERCTL Line CONTROL with 


SEREPENEAENSE? declared as INPUT/OUTPUT. 
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TELETYPE © 


NAME: CANDEIOTTY 


This is an input/output conversational POINT=~ -TO-POINT teletype 


REQUEST.j It performs similarty to the standard teletype REQUESTs 
with the following additions: 


ae This REQUEST is sensittve to Carriage Return CCR) as an 
: ending code on inpute | 


be If a BREAK is detected during a WRITE» the REQUEST 
transmits to the terminal (CBRK).~ $A flag is set to 
indicate to CANDE that a WREAK was requestede— 


Ce If an ENQ is sent» the REQUEST transmits to the terminal 
| CDEL) to indicate that the tast keyed-in message was 
discarded. | | 7 ; 7 


de Error recovery is similar to that of the other. CANDE 
Ce Carriage position is controttled by the needs of CANDE> 
| when the terminal is attached onty to CANDE> otherwise» 


carrtage position 1s maintained at the left margin on 4a 
clean tine for the next input or output. 


RJE/HOST 


The RJE/HOST REQUEST is similar to the RJE REQUEST» but has the 


abitity to communicate to the MCS. By setting TALLYCO] to a 


- value before sending a message to the ACS Cwhich may be a dummy 


message)» the Network Controller may inform the MCS of any status 
changes concerning any of the stations accessed by the REQUEST. 
one Settings for TALLY£O] ares. 
0 ‘Loss OF DSR detected © 
1 “DLE-EOT" either sent or received 
2 "DLE-ENQ™ received 
3 "ACK" received 


 & Message received 
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Cases 0 and 1 inform the MCS that the current station has 
disconnected and should be removed from the system. Cases 2 and 
3 infora the MCS that the current station has established and is 
entering the RJE systeme Case 4 flags the message as a DATA 
message received froa =e Station. Cases 0 through 3 are dummy 
stations. | . 3 | = 


In addition» the RJE/HOST REQUEST has the ability to go into a 
READ NO“TIMEOQUT state when a ~particular station fails to 
establish a connection. After 100 attempts to establish a 
connections the Network Controlter goes into a READ NO “TIMEOUT 
Situation until a user becomes active on that stations if the 
Line is a leased lines otherwise» it is disconnected. 


The RJE/HOST REQUEST also contains a mechanisa where if a etLine 
becomes established and after 100 READS no indication of activity 
is seen» the tine is disconnected. A message received with 
TOG(31] set turns this mechanism off» while a message received 
with TOGEL4] set or a termination of the connection cause the 
- mechanism to be turned one LINECTALLY(£5]) is used as the counter 
for this retry mechanisme | - af if 


This REQUEST also supports DIALOUT. LINECTOG(71) is used to 
indicate a DIALOUT state. Should DIALOUT fail» a dummy message 
1s queued for the MNCS. | | | 


LINECTOGES)) 1s used as an indication that a termination request 
was recetved from the ACS. | | : | e 3 


<a ot a ape 


The. " SYCOMREG Leia is derived from the RJE/HOST request and 


uses the same basic RJE tine disciplines It contains the 
een extra features: | OS . 8 a | 


TALLYLO] now means error information sent to ‘SYCOM 


7 TALLYC 61. ised to "CONNECT a virtual (server) terminal 
_7 chype o)) | 
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TALLYC7) sed to "DISCONNECT" a virtual Cserver). enwinee 
CT ype=61) 

‘Error handting has - been Improved. This request needs the. 


SYCOMOECL declaration and is designed to run in conjunction onty 
with the SYCUMCTL control. : 7 | 


RJES7SO 
NAME: —RJEZT7BOR AST 


The RJE3780/HANDLER REQUEST section handtes the input and output 


for a Binary~Synchronous line discipline CBISYNC). It is one big 
case statements driven by the vatue of *LINECTALLY(L0])". In this 
section responses to the Host are built and sent» data is packed 
and sent to the Host» and tine errors. are handlede The REQUEST 
is designed to relieve the MCS of the ordinary processing of 
messages (except for data)» tine bidding» and error handling as 
it. pertains to autotdialout and line control. | The REQUEST ts 
designed to accept input from one or two stations. For a 
complete description of how this REQUEST interfaces with the 
KJE3780 package» refer to the RJE3780 Product Specification» 


#2219 0391. This REQUEST requires the RJE3780DCLS DECLARATION 
sectione | 7 


By 
He 
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The purpose of a CONTROL 1s to assign a station for setiwaty and 
initiate the proper REQUEST to perform a communication Procedure. 


This isi ot CONTROL can handte a line with more than one 
station —T | _ 


NAMES POLSELCTL 


The basic purpose of this CONTROL is to initiate the appropriate. 
input CPOLL) or output CSELECT) REQUEST after having assigned a 
station to the line that is READY to communicate. LINE CTOGCiI)) 


ais set false indicating that AUTUPOLL is not being tnitiated. 


Upon eoambetion of i ceeehaus REQUEST» CLINECCONTROL KEY) = 6) ee 


upon notification of system reconfigurations CLINECCONTROL KEY) = 


1) the CONTROL checks each station on the line starting at the 


next statione If the station is READY» QUEUEDs» and MYUSE is not 


INPUT ONLY» the output REQUEST is tnitiated. If the station 15 
READYs ENABLED» and MYUSE is not OUTPUT ONLY» the input REQUEST 


3s initiated. The failure to find any station on the line whose 
REQUEST can be initiated causes the. fine to be put in the IDLE 


Statee LINE (TALLYC1]) jis used to determine when att the 


stations on the line have been checked. 


When the tine has a READ with NO TIMEQUT pending and a message is 


QUEUED for the tine where there was no prior message in the 
queues the CONTROL is entered with LINE CCONTROL KEY) = 2 and the 

CONTROL cancels the I1/0 in = process. The CONTROL is then 
 retentered with LINECCONTROL KEY) = 0. | 7 | | 


If the station establishes itself on a switched-lines the CONTROL 
as entered with LINE CCONTROL KEY) = 3 or LINECCONTROL KEY) = 5 If 


ty, P 
yh 
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ACU; the CUNTROL sets LINE (T5G{5]) = 1. Upon failure to 


initiate any REQUEST for the station» if LINECTOG(5]) = 1 and the 
fine is QUEUEDs> the line ts disconnecteds otherwise it is tidled. 


if a REQUEST performs a TERMINATE OUTPUTCRETURN)» the CONTROL is 


entered with LINE CCONTROL KEY) = 4. The CONTROL performs a 
CONTINUE which assigns an output message buffer to the line for 
the same stations if one is queued» and returns to the REQUEST 
froma which the TERMINATE OUTPUTCRETURN) was executed. 


LINECTOG(4)) has been provided for the convenience of the User 


Program for flagging an "ACU" Line. This TOG is not set or reset 
in the REQUESTs or CONTROLs. | 
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AUTOPOLL 


NAME ‘AUTOPOLCTL 


‘The Bea purpose ne this CONTRUL is to initiate the appropriate 
input CAUTOPOLL) or output CSELECT) REQUEST after having assigned 
a station to the tine that is READY to communicates LINE 


 (T0GC1)) is set true if the tine is to be autopolled and if the 
 AUTOPOLL string has already Deen created. LINE C(TO5{0]) is used 


to save the contents of LINE CTOGC11) indicating that the POLL 
String has atiready been created when a normal POLL is to de 


Upon eeaniorsan of a previous REQUEST» CLINEC CONTROL KEY) = 0) or 

upon notification of system reconfiguration» (LINECCONTROL KEY) = 
1) (which also sets LINE (TOGCO]) and LINE CTOGL11) false thereby > 
indicating the AUTOPOLL string is to be recreated)» the CONTROL 
determines if the line has any messages QUEVUED for any of its 
stations. If there are messages QUEUED» the CONTROL checks each 
station on the tine starting at the next station. If the station 
is READY» QUEUED» and MYUSE is not INPUT ONLY» the output REQUEST 
is initiated. If the station is READY» ENABLED» and MYUSE ts not 
 GUTPUT only» LINE CTOG{1]) is saved and set fatse to indicate no 
AUTOPOLL» and the input REQUEST is initiated. LINE CTALLY{£11) is 
used to determine hou many stations have been checked. 


if there are no messages QUEVED for output on the Line and LINE | 
CTOGC11) is true» AUTOPOLL is initiated. If LINE CTOGCL1I) is 
fatse» an AUTOPOLL string is created for the tinee Each station 
on the line that is READY» ENABLED» and MYUSE is not OUTPUT ONLY» 
is put into the AUTOPOLL string until all the stations have been 
checked» or the AUTOPOLL buffer» defined in the LINE Section» is 
fitted. If at teast one station was put into the AUTJPOLL 
strings LINE (TOGC11) and LINE CTOGL0]) are set true. This 
CONTROL adttows a station to appear only once in the AUTUPOLL 
Sstringe If LINE (T0611) is true AUTOPOLL is initiated. If LINE 
 (TOGC11) is = fatse» and LINECTOG£5)]) is true» the line ts 
disconnected. Otherwise it is put into the IDLE state. 


“When the line has an AUTOPOLL I/0 in process and a message 15 


 @UEUED for the line where there was no prior message tn the 


queues the CONTROL is entered with LINECCUNTROL KEY) = 2 and the 


poise Shei ob ab i ad oe Shao Ace Se ie ie oo BG 2: he ee oe i SE a a 2 i Sic ten cg SR Sc SSS SR CR 9 Be es eg as 


Ke apleReat bey lotta 
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CONTROL cancels the I/0 in process. The CONTRUL Ps, Oren 


re-entered with LINECCUNTROL KEY) = Of 


If the AUTOPULL I/O. continues in process without any output 


message being initiated at the terminals for a period of 30 


seconds» the Skeletal Network Controller automaticatly enters the. 


| CONTROL with LINECCONTROL KEY) set to a value of 2. The CONTROL 


determines that no message ts QUEUED and does. not cancel the I[/0>» 


altowing it to continue as before. The purpose of this automatic 
WAKE*UP is to allow. a CONTROL to cancel an 1/0 that may continue 
FOREVER if no terminal or systea activity occurs to interrupt it. 


AUIGPOLL and READ with NO TIMEOUT are two such FOREVER I/0's. 


see the — description for the AUTOODYNCTL CONTROL for = an 


iaplementation of this feature. 


If the station establishes itself on a switched-Line» the CONTROL 
is entered with LINECCONTROL KEY) = 3 of with LINECCONTRUL KEY) = 
5 if the line is Automatic Dial-Up CACU) at which time the 
CONTROL sets LINE (C(TOG(51) = 1. Upon failure to initiate any 


REQUEST for the stations if LINECTOG£5]) = 1 and the tine is 


QUEUED» the line automatically disconnects. Otherwise» it 15 put 


tnto the IDLE State. 


If a REQUEST performs a TERKINATE GUTPUTCRETURN)» the CUNTROL is 


entered with LINECCONTROL KEY) = 4-e The CONTROL performs a 
CONTINUE which Lets an output message buffer be assigned to the 


line for the same stations if one is QUEUED» and returns to the 
HEQUEST from which the TERMINATE OUTPUTCRETURN) was executed. 
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DYNAMIC 


WAMES AUTODYNCTL 


This speciat CONTROL is intended to provide dynamic 
re-configuration of the AUTOGPULL POLL tist when stations defined 
ona tine are not responding or when any of a defined set of 
Stations may become attached to any of the tines of a group as in 
Switched operation on dialwin lines. 


The CONTROL performs four basic functions: 


as : -Beteraine the paenenoina stations on a tine by single 
potling each station. 


De. Build a POLL List containing only the responding stations 
and initiate AUTOPOLL for Ver ele 


Ce if any station was found not responding» to initiate and 
7 Baintain a three (3) minute timer which norton as steps Il 
and 2 againe | 


de Initiate output to a station as necessary if the station 
is READY and VALID C TALLYELINE] = 0 or 4). 


if nao stat ions are found ENABLED then the CONTROL resets 
TALLYCLINE] to 0- , : 


This CONTROL has severat enhancements over the AUTOPOLL CONTROL: 


@-e —s- Stations which are not ONLINE Cpowered off)» are deleted 
from the ueepere POLL string. i 


De If output cannot be sent (terninal in LOCAL or XHMT)» att 
terminals are AUTOPULLed once before going back and 
SELECTing again. es : | 


Ce - The first time output 15 attempted» a FASTSELECT is usede 
«Tf the FASTSELECT fails» a normat SELECT is used to 
conserve line timee : : 


de This CONTROL is designed to handte. Line groups and 
switched~Llines. | | a ‘et _ 


ihe 
is 
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Ce If a station has output and it is powered off or taken off 


tines no more attempts are made to send a to it until 
can be ees parees againe 


sont emule does an automatic reconfiguration every three (3) 


minutes. For targer configurations» the user shoulc increase 
this interval to avoid continuous | reconfigurations. 
Reconfiguration is accomplished by placing perviousty dead 
stations into the POLL string. In order to. avoid interfering 


with active stations» the dead stations are put in at the end of 


the POLL stringe These stations are removed from the POLL. end 
if vey TIME QUT againe 


Unce a station is actives it is not removed from the POLL string 
unless it. TIMES OUT three (3) consecutive times» or is made NOT 
READY. | 


The AUTOPGLL buffer declared in the LINE Section of the Network 


Controiter must be five (5) times the number of stations on_ the 


tine plus five (5). 


If the Boolean CLINECQUEUED) is set and no stations are 


responding» and the line was established as switched» it ais 


disconnected» otherwise atl stations are again single polted to 
determine if any stations have come on line or changed status to 
alfiow LINECQUEVUED) to become false. Exception on output is 


reported to the User Program when RETRY is exhausted. 


See the comments at the head of the Oynamic REQUESTS and CONTROL 


POLTCTOCYNs SELTCTDDOYN» and AUTUCDYNCTL for a full explanation of 
the purpose of each variable used by this CONTROL. 


Because TALLY is indexed by Line CTALLYCLINE) MAX TALLY must be 
set in the DECLARATION sectione If the REQUEST its not modified 


furthers MAX TALLY should be set to the number of lines in the 
—  metworkse Eeges MAX TALLY (51 for five Lines. 
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NAMES CANDETOCTL 


The CANDE control is intended to service stations with terminals 
of type TD or TC series» The CONTROL and the REQUESTS perform 


similarly to the standard CONTROL AUTOPOLCTL with the following 
exceptions. } | 


ae. If five consecutive outputs» by a euts are sent to a 
station and more outputs to that station are stilt QUEUED, 

output activity is temporarily interrupted» and AUTOPOLL 

is initiated in order for input to oe handled. CANDE 
queues onty one screen~fult of messages to aterminal at a 

times CANDE can be informed of a terminat'*s screen size 

in nuaber of 60~“character’ tlLines.» Typically onty one 
message is sent in response to one input from the 
terminal. : | 7 


De The AUTOPOGLL POLL string containing the station addresses 

| is maintained dynamically as explained in the comments of 

the CANDETDCTL Listing. Basically» onty those stations 

that are ONLINE (Cresponding with an EOT or SOH when 

polled) are kept in the POLL string. Every fixed time 

period (li minute)» one station previously considered not 

|) My -_ ONLINE is single~polled once in order to redetermine its 

: |  «~ONW“LINE/OFFTLINE status. If none of the stations respond 

: | as being ON“LINE» each one is singie-polled (rather than 

autopotted) in turn until alt have been tried once. I f 

none were found online then the tine is idted for 2 
minutess by default. | _ ware : | | 


AUTUPULL is initiated with a TIMER value depending on the 
current condition of ‘the Llinee This TIMER vatue 15 set as 
follows ° | | 


a. One (1) second if output 1s queued for any station 
3 on the Lines else | | : | | 


2. Two (2) minutes if input from any station is 
oO disableds else | ! | | 


3. EEN ee but interruptible. 


ce If no output 1s quaied for a tine» and atl stations are 
| NOT READY or input is disabled» each Station is 
Singlepolled once then the ‘tine is idled for two <e7 

Binutes after which the CONTROL ‘Vs renmentered. 


ue 
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NAME? CANDAUDCTL 


This controt is the same as "CANDETDCTL™ with bie + eaditaonm cot” 
audit. ‘Statements. | Z 


“PQINI=10=POIAT ONTROLS 


This we CONTROL handles a tine with more than one station 
attached excect in the case of the CUNVERCTL CONTROL which may 


only: have one station defined per line. 


| CONTENTION 


NAMES. PTPTCONCTL 


The basic purpose of this CONTROL is to “SaieG ate the appropriate 
input or output REQUEST to a station on the tine. Currentty» 
there may be only one station assigned ‘to a Line using this 
CONTROL if REQUESTs TCTUPTXMIT> TCTUPTRCV> ofr TCTUPTiIO are 
utilized. However » several stations may be concat enated on a 
Single line if REQUESTs TOPTXMIT» TOPTRCV» or TOBATCHXMT are 
used . | 


Upon cospletion of a previous REQUEST CLINE CCONTROL KEY) = 0) or 
notification of system reconfiguration (LINE CCONTROL KEY) = 1)» 


the CONTROL checks the station on the Line. If the station is 


READY» QUEUVED» and MYUSE is not INPUT ONLY» the output REQUEST is 


initiated. If the station 1s READY» ENAG6BLED» and MYUSE is not 
GUTPUT ONLY» the input REQUEST is tnitiated. The faiture to 


- initiate either REQUEST for the station causes the line to be put 
in. the IDLE stat e. | 


| eink ewer fans has a READ with NO TIMEOUT pending Cinput PT-TO-PT 
contention REQUEST) and a message is QUEVED for the tine where 

there was no prior message in the queues the CONTROL is entered 
With LINE CCONTROL KEY) = 2 and the CONTROL cancels the I/0 in 


processes | The ae is een re-entered with LINE SCURTROT KEY) 
= Qe 


es 
ny 
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if the station establishes itself on a switched-Line» the CONTROL 
ts entered with LINE CCONTROL KEY) = 3 or LINECCUNTROL KEY) = 5 


if the tine is Automatic Diat-Up CACU) at which time the CONTROL 


sets LINE (TUGI51) = 1. Upon failure to initiate any REQUEST for 
the stations tf LINECTOG(5]) = 1 and the tine is QUEUED» the line 


-automaticalty disconnects. Otherwise» the tine is put into the 
 £0LE states | | ian 


If a REQUEST performs a TERMINATE OQUTPUTCRETURN)» the CONTROL is 


entered with LINE CCONTROL KEY = 4).  $=The CONTROL performs a 
COATINUE which assigns an output message buffer to the line for 
the stations if one is QUEUED» and returns to the REQUEST from 
which the TERMINATE QUTPUTCRETURN) was executed. 


sseiaecieiadis 


NAMES CONVERCTL 


The basic purpose of this CUNTROL is to initiate the appropriate 
input or output REQUEST to the station on the linee There may be 
only one station assigned to a tine using this CUNTROL since this 
is a POINT“TO“POINT conversational tine CONTROL. 


Upon coapletion of a previous REQUEST» CLINEC CONTROL KEY) = OD» 
or aotification of system reconfiguration» CLINECCONTROL) = 1)» 


this CUNTRUL checks the station on the tine. If the station is. 


READY» ENABLED» and MYUSE is INPUT/ OUTPUT» the CGNTRSL obtains an 
input/output buffer and initiates the REQUEST. If the station is 


QUEUED but not ENABLED» the CONTROL initiates a a onty. 


If the station eavabuienes. itsetf aa a Suit chedet nes the CONTROL 


is entered with LINECCONTROL KEY) = 3 or LINECCONTROL KEY) = 5 if 
the tine is Automatic Diat-Up CACU) at which time the CONTROL 


sets (TOG{£5]) = 1. Upon failure to initiate any REQUEST for the 
stations if LINECTOG(5]) = 1 and the tine is QUEUVUED» the line — 
_automaticaily disconnects. Otherwise» the line is put into the 


i DLE state. | 


If a REQUEST performs a TERMINATE OUIPUTCRETURN)» the CONTRIL is 
entered with LINECCONTROL KEY) = 4e The CONTROL performs a 


CONTINUE which assigns an output message buffer to the line for 
the statton» if one is QUEVED» and returns to the REQUEST = from 
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which the TERMINATE OUTPUTCRETURN) was executed. 
REMOTE JOB ENTRYCRIE) 
NAMES RJECTL 


This special RJE CONTROL operates in a manner similar to the 
CONVERCTL CONTROL except that it may be used to handle a tItne 
which has more than one station attached. | 


Four (4) stations aust be declared for each line in the Network 
Controllers and onty one (1) Line group is permitted. 
LINECTALLY(6])» LINECTALLY£73)» and LINECTALLY(81) are used Dy 
this CONTROL to govern the stations on the tine or the stations 
on each line within the Line group. 


Unty | the. special | input/output | REQUEST named RJEHOST are 
recommended for use with this CONTROL. | 


See the coements at Bie head of the REQUESTS” RJE and RJEHOST for 
a coaplete description of. the DUrpose of each Hae vane used by 
this CONTROL. , 7 | 


SYCOM 


—_ SYcuMCcTL 


This SYCOM control is based on the RJE/HOST. control with an extra 
‘interface to SYCOMREQ to improve error handling- The line group 
oun eon gon eeo 3 | 


This contrat requires the SYCOMDECL declaration ane is designed 
tor use a ete the eee Eequests 
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RYE 3780 


NAMES RJE3780CNTRL 


The RJES760/HANDLER CONTROL section is designed to drive the 
RJES7BORQST input/output REQUEST. The CUNTRUL begins with a case 
statement which is driven by the value of "LINECCONTROL KEY)*. 
In this case statement» TOGGLES and TALLYS are preset so that the 
proper actions will be executed in the request sectione For a 
complete description of how this CONTROL interfaces with the 
RJE3780 package» refer to the RJE3780 Product Specifications 
#2219 O391. This CONTROL requires the RJES780DCLS DECLARATION 
sectione — _ : | : _ | 


REQUEST YS- CONTROL 


~ om € o fm 


wi Ce id a bis pr a 
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 B1800/781700 NDL LIBRARY 
ASSOCIATIVE HAIRICES 
co N T ROL 


t12i2r,staotstoetriaertg9sgt tot 


eam a ewen aa swangn ong_naetoaateoangwoay_mangrowmgec ower onn | 


1 POLLTCTO 1xaexe i 4 re ee nb 


cae ea ceri Ll cd eles a, delet, ieee eke. eeoanel clade Se elical | 


t POLTCTOOYN § & § D te$4exe ft | i 


(| Pe ewe meme wan gwen te cm gmes gree poem Pee Pees ES oe Er any_m aa | 


§ SELECTCTD #xetxe 6 1 rn | ns ee | 


 Keteteeheietetetetetetel tale teleted, teketed, Sete tele telebel, telat, tele tate coke | 


§ SELTCTODYN 1 i 4 it i 1X i ae? i 4 


§ ee ee ew eee Oe fe ee gm egw Oe $m we eee ES Oe FO SR ET ET EWS EC OMe | 


i FASTSELTCD 1X 4X1 i 4 t 1 i ae 


et Cketetedeteedelelete eteded, teed Soke tke telat teed, take tell aah eee 


i TCTUPTXMIT 1 i eexe tf i if i 
 Kelteteeletetetetetetet tele dededet tele teleteh tokeled telat tekeled tetetet, Seled teletetel Oe 
4 TCTUPTRCV. 1 bi eexe bt Ff ft ee | ' 
 Relteteteteteetetellet Solel teleted teletel toleteh tolketad teketet taketh tetekedt, telat teketeteel | 
i tcrupTio § 1 hb @xet of ft bt bt 5 
[awseS sss eee 4S e= 4 SS 7S $4 = =$ 49834 = 994499 eS = te te cee] 
4oTOPTXMIT &@ @ @ Xe § ct FF § 1 i 4 


 Ctelatatetatatetetetaten teketek teleted telelet teketel taleted taletel telat teetel cabal caleba | 


 § TOPTRCYV. | ix i f ee | : 4& F i 


 ltete tet etetet! ty a eb i ee | 


| TOBATCHXMT 1 : 1x s 4 i 4 \ i 


| Rlteetieteteetee tee, telhed, teeth teed, celetek, debe teed eet, tee Deete meee | 


1 WRITETTY i exe i tt #4 4 ( " 


leita ett tey? toe ty oot oo eo oo re 


P READTTY @ @ © XH F FF FF FF 4 1 
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REQUEST YS- CONIRUL Conte) 


C ON ” Ru L 


(1120304615 161718191 108 


 Retlatetetetetetetetate tetetek eleted telat teketel tolelad toleted toketed tedeleh tolatel tetera | 


| RJEHOST Mot © @ ¢xXt tb § bt bt 4 


OO lela leletateleletetel tale! tlety titel? iit ity Te te ce corer Sorerenag] 


1 CANDEPOULTO 1} { 1 1 i i exe ag XS i 


Se Related ikea tekeled tekeled teketed, tolketed tokatel toketek teketl tketet deleted | 


1 CANDESELTO §# &§ @ © © FF EXE ENE 4 


| teehee eae teed tthe ceded Deleted teehee tele, tke, elle, delete dette | 


i CANDEFSLTOD § &§ 4 1 rs nn ee i re | 


ma 


| chat eiet battens tated telat taketh celeste Delelel caked taketh Dee need, teed | 


§ CANDEIOTTY #1 t xi t 4 : rn 


q 
U Cteletetetetateteteletee tletet teletel tetetel tot tte ti? toe ee oy eee 


| DIAGTCTOIO «xX tt Xt ¢€ -t tf 4 ne | i 


E | Resbekatetenietetete tated, tokeatet dodetek totetel daketed coketed coketed teketeed doateket toketed tokaketed | 


i RJES7TBOROSTi § & fF tobe!) Xt: 


Ss | chatetteteteteteteateteh teleled teletet Delete tole ele tele teletn telelet tell eked Oe 


§ CANDAUOPOL | JU 1 i 64 1 ix i Xt 4 


T Redehall lela taked telat tetelet Sokeled teketed tole toketed teleted toleled toletet totaled | 


§ CANDAUDFSL 1 i i 1 Z| i '1xb exe. { 


EE Rl ttethetetenteatenl Yetehek tetedek debated toketed tudetek, teckel’ teaketek datebel, tekelent, dotetetel 


{ CANDAUDSEL ! 34 1 i 1 1 1x +x 4 


Testun creations alain, delaleds Sede: tele, telcos Deceit ula, eadedoed, tone called, Soa aa 


t SYCOMREQ = 1 root on i tobe ; 1x 3 


X= RECOMMENDED USAGE 


CONTROLS 


POLSELCTL | 
AUTOPOLCTL 
PTPT CONCTL 
CONVERCTL 
RJECTL 
AUTODYNCTL | 
CANDETDCTL 
RJE3780CNTRL - 
CANDAUDCTL 
SYCOMCTL 


i ae 
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REQUEST VS_ JERMINALS CURRENTLY SuPPORTED 


TERMINALS 


rrizeseas rsto6t7'81Ot 108 


a latelatateietatatatatates talatel tateted tateted tateteh atated taletel teleel telat telat tliat 


|! POLLTCTID txexexexnexexexe @ 4 j 


§ et ee em mmm mom eee ew Ce fees Fe OBL en fe ewETorETaamErmogoce—| 


| POLTCTDOOYNEI XI XEXEXKXEXEXEXtE tf ot : 


Peser Ser rSs ses See toasts ter tert er ter teen east eee: 


§ SELECTCTO @ X §'XEKXENRGENaEKXEX! § ff 1 


[eee eer Sets = t= F945 os (Ser teen te ee eet eee | 


AU SELTCTOOYNE XEXEKXEXEKEXEKE FF Fo ob 


 Retleteatatatetntete Ketel Sette caletal Seletel tooketel toketed toleted teketet taleted todelet telketatel | 


| FASTSELTCD 4X 1 XEKXeKeXxexexe tf bt. t 


Solettetetteteleted teketel tte! tia? oot Pe oY oo So 2 ry ee 


t TCTUPTXMIT 1 X § 8 X 1 i 4 i oo4 ne en oe 


Litt ttt! oot a oe oe err rey Ct hare eg 


§ TCTUPTRCV #xXdtexed 4 i oF ff tf £4 


erre sS9$S 99 § $5445 5=5 4544648 4 oe$ 4354 34-444 S=5 45>) 


itctueTIO txt @ Xt £ € F€ FF bt tf 4 


a ee ee ee ee ee ee erry 


1 TOPTXMIT & & &@ 8 § Xt t tt € fF 45 


) (esse ss sean eS 49 SS 13898525 te S64 28242 S= ts 2 eset SS ¢ee=2 | 


t TOPTRCY ' 1 1 6 sexs es cn a | | 


| et ee oo wm om ge 2 gw emt eee pees Em ee penny cam gras Foenteooe= | 


-§ TOBATCHKMT UX EX FF F £ tb bb 


joe ce ee eee ow on fe eed wm oe ge ee Ee weg Cem Zee Zocor *ErorseToaz_roe={ . 


{1 WRITETTY 1 ee | | | xi it 


| om en a nw wn pe ng aw ong we mn gn on penn pa nn ga mn peee gene goee=| 


PP READTTY tb fF bo tf b§ t xeon 
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“REQUEST VSe TERMINALS CURRENTLY SUPPORTED CConte) 
| TERMINALS 


| r112estarstorze 8 '94 101 
aa ;  Kateelaeteee et tatekatedh teketet edeted tote tated Dalek ceteten tetete teee tekenel deel | 
PP, e | i RJEHOST re ee | | i © @xs i 
Bo | | a acorn a a aaa le a ela a acl aa 
| R$ CANDEPOLTO § #Xt § UN &€ F§ FF ££ 4 
| |  ocbatetetette etait Debate, teleted Sede teeth theta taketed, take tele teed teetetel | 
ZZ -_ E § CANDESELTD 1 Oxe§ ie a t 
: | | EE Cellet tetatatettae teleted debetel eked toketed tokeled teketed, tekeled tele toketed, eke | 
Q 1 CANDEFSLTDO 1 ix text 4 if io 


 aleaieieiebeteeeteieten Dede teed Deke, teed Deke tele dedi, tele pede diel 


1 CANDEIGTTY 1 1 ; é ; i i 1x ee ie 


J ow ee oe cme emg ent wen gree fe ee gwen sea gawe Foe pPomapoes=|] 


U 
E «vIaGtcmopigo +X i xt xaxexexexe a ot I 


{ww en oe eww e wade wets eaten fee sw ee Ee se Pree fee Fw way_ en awe | 


S IRJES780CNTRLI 4 i s4 ieo4 ist 1x i 


eee eae, ele Selo dled coeliac, ceo eh deka seca oles eae 


T  ¢ CANDAUDPOL t ft © © © FF FXE OF KA 4 
[eSee sore eee 4s sete sStSes thos ter rset sehen te te oe 
{ CANDAUDSEL 1 ee ( wx ix 7 

| en ww ee we Gen gn cng cn pane pe me pe en pm ee poem poonpo nea | 


1 CANDAUDFSL 41 4) 1 re ee | 1x xi ot 


Neen oneal lae ed, cla onal Deal hein ero ela cle dade cali, aki 


1 sycomREQ @ t @ © § © © &€ #txeRexos 


X = RECOMMENDED USAGE — 
; | TERMINALS 
: 1 = 16500» TC700 
(2 = TC3500» TC4900» TC5000 
; 3 = Tu500 
| 4 = TU700 | | | 
a 5 = 10700» TD800» TD820+ 10830 
: 6 = T7142» TT602 
‘| 7 = $1200> S.700 
| 8 = TELETYPE» REDACTOR I CITY) ~ - 
| 9 = REMOTE APPLICATIONS» SYSTEM TO SYSTEM 
10 = REMOTE APPLICATIONS» SYSTEM TO SYSTEM CVIRTUAL STATIONS) 
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APPENDIX A 


To obtain a listing of atl the DECLARATIONS» REQUESTS» and 
CONTROLS contained within NOL /LIBRARY» the user should employ the 
following deck. | 


-$ CONTROL 
$ LIBINFO 
2 END 


‘The output of. this deck will be 3 Listings: a list of compiler 
error messages which should be ignored» a list of program 
‘Statistics which also should be Ignoreds and the dist of library 


Statistics shown betowe 


a | BR ARY STATISTIC Sz 


EXTERNAL FILE MAME: | 


PACK ID = : 
MULTI-FILE ID) = NODL 
FILE ID = LIBRARY 


CREATION DATES 6/1/79 
LAST ACCESS: 8/23/79 


DE RECTOR Yt CCONTAINS 41 ACTIVE ENTRIES) 


NO. SUB_FILE_ NAME LENGTH TYPE 


> <P cree eR ewe eR cane ee ee cone GD ew ewe ae <P 28° «om com ~<a) ae a te <P ew ne <a OP aw ene ou op) cum cm <P 8m <0m a oe 
os SO ED ND ED RD OER OD ED END ED ED OR ED Ee RD ce ce em ce ee ee a ee ee ee ee ae 


COPYRIGHT 27 DECLARATION 


1 
2 RJE3780DCL 33 DECLARATION 
3 CANDEDEC 22S DECLARATION | 
ly CANDAUDDEC 26 DECLARATION 
— § .  SYCOMDECL 208 DECLARATION | 
6 COB0L74DEC 43 peer an euloe 
7 POLLTCTD ~ 128 REQUEST 
8 POLTCTODYN | 213 REQUEST 
9 SELECTCTD 101 REQUEST 
= 20 SELTCTDDYN _ 153 REQUEST 
211 &#FASTSELTCD. 77 REQUEST 
1200 «so TCTUPT XMIT. 93 REQUEST | 
13. TCTUPTRCV 110 REQUEST | 
14 TcTuPTio 196) =~ REQUEST 
15 TOPTXMIT «42400 «REQUEST 
16 ‘TOPTRCV = 137 REQUEST 
17 «= TOBATCHXMT 102 REQUEST. 


18 + j.WRITETTY —| 95 REQUEST 
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OL R E c TOR ve CCONT.) 
NO. SUB_FILE_NAME LENGTH TYPE | 
19 READTTY. 70 REQUEST 
20 RJEHOST 477 REQUEST 
21  SYCOMREQ 336 REQUEST 
22 CANDEPOLTD 308 REQUEST 
23 CANDEF SLTD. 260 REQUEST 
24  CANDESELTD 262 REQUEST 
25 CANDAUDPOL 331 REQUEST 
26 =  CANDAUOFSL 277 REQUEST 
27 CANDAUDSEL 279 REQUEST 
28 CANDELUTTY 146 REQUEST 
29 ~DIAGTCTOIO 240 REQUEST 
30 RJE3780RQS 618 REQUEST 
31 COBOL7 4SEL 138 REQUEST 
32s POLSELCTL 116 CONTROL 
33 AUTOPOLCTL 150 CONTROL 
34  AUTODYNCTL 367 CONTROL 
35. PTPTCONCTL 39 CONTROL 
36 CONVERCTL 73 CONTROL 
37 RJSECTL 83 «CONTROL 
38 = SYCOMCTL. 103 CONTROL 
39 | CANDETOCTL 514 CONTROL 
40 CANDAUDCTL 541 CONTROL 
41  RJE37B0CNT 75 CONTROL 


PROGRAM STATISTICS: 


MEMGRY REQUIRED TO RUN: 23893 BITS PLUS MESSAGE"QUEUE SPACE 


MEMORY REQUIRED FOR NIF TABLES? 329 BITS 
NUMBER LINES: — 0 | 

NUNBER STATIONS: 0 

NUMBER TERMINALS: ~~ 0 

NUMEER FILES: Oo; | 

NAME STACK SIZE: 2 ENTRIES 

CCANTROL STACK SIZE: 15 ENTRIES 

PROGRAM POINTER STACK SIZE? 25 ENTRIES 
EVALUATION STACK SIZE: 20 ENTRIES 


VALUE STACK. SIZE: 17329 BITS 
PROGRAM STATIC MEMORY: 20369 BITS 
_ PROGRAH DYNAMIC MEMORY: 0 BITS 


REQUEST PAGE: 10 | | 
SEGMENT SIZE IN Erte 
00 | 0 


CONTROL PAGE: a a 
SEGMENT ‘size IN BITS 
000 0 


Z| 
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COMPILE STATISTICS: 

- NUNBER OF ERRORS DETECTED: 
NUMBER OF WARNINGS: 0 
NUMBER OF CARDS SCANNED: 
NUMBER OF TOKENS SCANNED: 
ELAPSED TIME 200200:09-9 
PROCESSOR TIME 2:00200:00.8 
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APPENDIX A A-1l : 
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CONTENTION 3°29 
CONTROLS 3-22 
“CONVERSATIONAL 3-30 
DECLARATIONS 371 | | 
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FAST SELECT 3-12 | 
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NOL/LIGRARY FILE 371 | 
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